home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / lang / c++-part1 / 2750 < prev    next >
Encoding:
Internet Message Format  |  1996-08-06  |  4.1 KB
  1. Path: eua.ericsson.se!usenet
  2. From: euamts@eua.ericsson.se (Mats Henricson)
  3. Newsgroups: comp.lang.c++
  4. Subject: Re: Coding Standards for C++
  5. Date: 19 Jan 1996 13:58:18 GMT
  6. Organization: Ericsson Telecom Systems Labs, Stockholm, Sweden
  7. Message-ID: <4do81q$380@euas20.eua.ericsson.se>
  8. References: <4dhuok$qpl@news3.digex.net>
  9. Reply-To: euamts@eua.ericsson.se
  10. NNTP-Posting-Host: euax3i4c06.eua.ericsson.se
  11. NNTP-Posting-User: euamts
  12.  
  13. In article <4dhuok$qpl@news3.digex.net>, gettier@rdaconsultants.com (Al Gettier) writes:
  14. >My company has given me the responsibility of coming up with some
  15. >coding standards for our developers.
  16. >
  17. >I would like to tap into the experience of others in this area, and
  18. >reuse any ideas others have.
  19. >
  20. >Has your company prepared coding standards for C++?  Did they have a
  21. >positive effect on long term productivity?  Can you share those
  22. >standards?
  23.  
  24. Hi!
  25.  
  26. Below is a description on how to get the Ellemtel public domain
  27. programming standard by ftp.
  28.  
  29. Best regards,
  30.  
  31. Mats Henricson
  32. Ericsson Telecom Systems Labs
  33. Stockholm
  34. Sweden
  35. ====================================================================
  36. "Public Domain" Coding standards for C++ in ENGLISH
  37.  
  38. Hi!
  39.  
  40. Our programming standard for C++ has finally been translated to English.
  41. In addition, some minor changes have been made. We believe that this
  42. version is rather stable, so that the next version should not be expected
  43. for quite a while.
  44.  
  45. Many people have aversions against programming standards. We recognize this
  46. and have therefore tried to make our document as flexible as possible.
  47. We have a set of 51 RULES (sometimes with exceptions) which we do not see
  48. any reason not to follow. Then we have a set of 79 RECOMMENDATIONS. They
  49. are meant as guidelines. We belive that most code should follow these
  50. recommendations, but we have ourselves recognized times when braking these
  51. recommendations are not only appropriate, but also necessary.
  52.  
  53. To you who really hate programming rules: we challenge you to try to
  54. reduce the number. We would be all too happy if you succeed, since we too
  55. are programmers and dislike rules ourselves.
  56.  
  57. The document only touches the subject of C++ design. The chapter on
  58. portability is sketchy. We have also tried to avoid subjects that we
  59. believe belong to an introductionary course in C++. 
  60.  
  61. The document contains 70 code examples. Many are simple, but some are
  62. quite complex. Most examples are possible to compile directly, while some
  63. may need some more or less obvious extra code to make sense for the
  64. compiler.
  65.  
  66. The document has the same copyright notice as the cool library,
  67. i.e. it is OK to copy and use the document, but we retain the copyrights.
  68. Also, we provide no warranty at all. If any of our code examples destroy
  69. your network, we will simply say "Sorry!".
  70.  
  71. The document was written using FrameMaker, but has been saved in Postscript
  72. and compressed. It can be accessed by anonymous ftp from our server:
  73.    euagate.eua.ericsson.se   (Internet Address: 134.138.134.16)
  74. It is in the directory:
  75.    ~ftp/pub/eua/c++
  76. The file is ~126k large and its name is:
  77.    rules.ps.Z
  78.  
  79. Extra info per 1992-12-18:
  80.    The above mentioned document is formatted for A4 paper. There is
  81.    also one document for US Letter, called rules.US.ps.Z. To this you
  82.    can add two similar mif-versions (Maker Interchange Format - editable
  83.    FrameMaker format) called rules.mif.Z and rules.US.mif.Z. Finally
  84.    there is a plain ascii version, called rules.ascii.Z.
  85.  
  86. Extra info per 1993-03-19:
  87.    Now there is also a plain ascii file called rules.MAX70.ascii. It is
  88.    formatted to have no lines longer than 70 characters. All tabs are
  89.    also removed and exchanged to plain spaces. This is to make it easier
  90.    to print on plain ascii printers.
  91.    
  92. If there are any problems in accessing or printing the file, please contact
  93. us at:
  94.    rules@eua.ericsson.se
  95.  
  96. All comments are welcome. Especially if you find any bugs or
  97. misunderstandings from our side. Please make it clear which version
  98. you have comments on, i.e. if you have comments on this version
  99. state "Version C in English" somewhere.
  100.  
  101. Erik Nyquist
  102. Mats Henricson
  103.  
  104. Ericsson Telecom Systems Labs
  105. Box 1505
  106. 125 25 Alvsjo
  107. Sweden
  108.  
  109.  
  110.